Notes/Domino 8 Forum

First, you need to install the Lotus Notes V8 beta software.

Then you need to set up Eclipse, which you can downloaded at no charge. You then need to set up Eclipse to work with the Lotus Notes environment. The following steps assume you installed Notes to the default location of C:\Program Files\IBM\Lotus\Notes and have a data directory of C:\Program Files\IBM\Lotus\Notes\Data. If your environment is slightly different, use your location in each place.

Start the Eclipse IDE and set the target platform by doing the following:

1. Choose Window - Preferences.
2. Expand Plug-in Development.
3. Select Target Platform.
4. In the Location edit control, type or browse to C:\Program Files\IBM\Lotus\notes\framework\eclipse.
5. Click the Reload button, and then click OK.

Next, you create an additional installed JRE:

1. Choose Window - Preferences.
2. Expand Java.
3. Select Installed JREs.
4. Click Add.
5. For JRE name, enter a name of Notes JRE.
6. Enter or browse to C:\Program Files\IBM\Lotus\notes\framework\rcp\eclipse\plugins\com.ibm.rcp.j2se.win32.<version number> for the JRE Home Directory.
For Lotus Notes Beta 3, this value is: com.ibm.rcp.j2se.win32.x86_1.5.0.SR4-200705170110
(NOTE: This populates JAR files to the lower part of the pop-up box.)

Next, you create a new runtime configuration by following these steps:

1. Choose Run - Run, and then select Eclipse Application.
2. Right-click and choose New.
3. Enter a name (for example, Notes).
4. Under Program to Run, select Run a product, and then select com.ibm.notes.branding.notes.
5. In the Runtime JRE, select Notes JRE.
6. In the Arguments tab, enter the following in the Program arguments text box:
-personality com.ibm.rcp.platform.personality
-product com.ibm.notes.branding.notes
-debug
-console

Enter these arguments in the VM arguments text box.

-Drcp.home=${notes.install}\framework
-Drcp.data=notes.data\workspace
-Drcp.install.config=user
-Dosgi.install.area=${notes.install}\framework\eclipse
-Dcom.ibm.pvc.osgiagent.core.logfileloc=${notes.install}\framework\rcp
-Dcom.ibm.pvc.webcontainer.port=0
-Declipse.pluginCustomization=${notes.install}\framework\rcp\plugin_customization.ini
-Declipse.registry.nulltoken=true
-Djava.protocol.handler.pkgs=com.ibm.net.ssl.www.protocol
-Djava.util.logging.config.class=com.ibm.rcp.core.internal.logger.boot.LoggerConfig
-Dosgi.hook.configurators.exclude=org.eclipse.core.runtime.internal.adaptor.EclipseLogHook
-Dosgi.framework.extensions=com.ibm.rcp.core.logger.frameworkhook
-Xbootclasspath/a:${notes.install}\framework\rcp\eclipse\plugins\${rcp.base}\rcpbootcp.jar;

Next, follow these steps to complete the runtime configuration:

1. Click Variables.
2. Click Edit Variables.
3. Click New.
4. Enter notes.install for the name.
5. Enter the path where you installed Notes for the value and then click OK. This path should not have any spaces in it. For example, if you installed to C:\Program Files\Lotus\Notes, your notes.install value should be: C:\PROGRA~1\IBM\Lotus\Notes.
6. Repeat steps 1 to 3.
7. Enter notes.data for the name.
8. Enter the location of your data directory for the value and then click OK. For example, use the default: C:\PROGRA~1\IBM\Lotus\Notes\Data
9. Repeat steps 1 to 3.
10. Enter rcp.base for the name.
11. Enter the version of the folder name for com.ibm.rcp.base plug-in that is installed for the value, and then click OK. This can be found out by going to the following location: <notes install location>\framework\rcp\eclipse\plugins. There is a folder that looks like com.ibm.rcp.base_6.1.1.<date>.
For example, in Lotus Notes Beta 3, this value will be: com.ibm.rcp.base_6.1.1.200705170110
12. Click OK and then Cancel to the Select Variable dialog box (if you click OK to select variable, it will add the variable at the insertion point).

To enable Notes security from the IDE, you need to uncomment two lines. In <notes install location>\framework\shared\eclipse\plugins\com.ibm.notes.branding_3.0.0.<version number>\notes_plugin_customization.ini, uncomment the following two lines by removing the leading # character:

com.ibm.rcp.security.auth/loginEnabled=true
com.ibm.rcp.security.auth/loginConfigName=NOTES

Now, select Run/Debug to launch Lotus Notes.

Finally, download the code with this article and unzip it to a new folder. To import it into Eclipse, you need to import the existing projects.